home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / zap2_5.lzh / ZAP2_5.TXT < prev   
Text File  |  1985-11-20  |  14KB  |  356 lines
  1.  
  2.           *** Almost Completely Superfluous Manual to ZAP 2.5 ***
  3.  
  4.  
  5.   *** What is ZAP ? ***
  6.  
  7.   ZAP is an editor, designed to edit program files.  That is why it cannot
  8.   change the length of a file, and why it displays files both in ASCII
  9.   and in hexadecimal code. 
  10.   It needs very little memory ( less than 25K ) and may be used on files
  11.   of arbitrary size, to at least a megabyte.
  12.  
  13.   ZAP is a 'public domain' tool. 
  14.   Copy it and pass it on as much as you like.
  15.  
  16.  
  17.   *** Why would I need ZAP ? ***
  18.   
  19.   For any number of reasons. Every time you want to know, and maybe to 
  20.   change, what is in a file that is not normally readable or printable,
  21.   you will find yourself reaching for ZAP.  
  22.   
  23.   Other possibilities:
  24.   
  25.   - Use it to change a default path in those irritating programs that 
  26.     do not know where to find your hard disk or ram disk. 
  27.  
  28.   - Use ZAP to modify text in programs of which you do not have the
  29.     source code, e.g. to correct spelling mistakes, or to translate
  30.     messages.
  31.  
  32.   - Use it to find text in programs, e.g. to look at vocabularies
  33.     of games (if they have not been encrypted). 
  34.  
  35.   - Use it to look for hidden messages in programs, and experience
  36.     the true hacker's thrill.... 
  37.  
  38.  
  39.   *** How do I use ZAP ? ***
  40.  
  41.   Very carefully.
  42.  
  43.   ZAP is a like a surgeon's knife: very handy to work with, but dangerous
  44.   unless you know exactly what you're doing.  As it may take only two
  45.   keystrokes in ZAP to ruin any program, one to change a byte and one to
  46.   write the changed data back to disk, I must advise you strongly to 
  47.   ALWAYS make a backup before experimenting. (Not that I ever do.  But then
  48.   I'm stupid.  YOU should know better.)
  49.  
  50.   ZAP, however, also has the possibility to protect a file from changes
  51.   on at least four separate levels, to prevent accidental changes. 
  52.  
  53.   - If the disk is physically write-protected, or if the file is
  54.     read-only, ZAP of course cannot change it. 
  55.  
  56.   - If you specify the -r option on the commandline ZAP will not change
  57.     the file.
  58.  
  59.   - If you lock the file during editing (click 'r/w' in the EDIT menu) 
  60.     ZAP will not allow any changes to the file until the lock is switched 
  61.     off again.
  62.  
  63.   - If you use the text filter, (click 'raw' int the EDIT menu) which 
  64.     displays only those bytes in the text field which are letters, 
  65.     digits, or punctuation marks, you cannot modify the file until you 
  66.     switch the filter off.  The reason for this is to ensure that you 
  67.     write only when you have full information on what you're overwriting. 
  68.  
  69.   - If you are in ESC mode ('ESC' displayed in the lower left corner 
  70.     of the screen) you cannot make changes to the displayed data. 
  71.  
  72.     ( Note, however, that if you first make changes in EDIT mode, then
  73.       switch to ESC mode, then get another chunk, ZAP will write the 
  74.       modified chunk to disk if you did not lock the file.)
  75.  
  76.  
  77.   *** Starting ZAP ***
  78.  
  79.   ZAP may be named either ZAP.TTP or ZAP.TOS.  It may be double-clicked,
  80.   or called from a shell. If a commandline is passed to ZAP, it will be 
  81.   used, or else it will start with a dialog to ask for a commandline.
  82.   In both cases the commandline must be of the same form:
  83.  
  84.   <filename> [ -r ]
  85.  
  86.   where <filename> is any legal TOS path/filename, and the optional
  87.   -r (or -R) the read-only option.
  88.  
  89.   Examples: "c:\zap.ttp -r" will open the file ZAP.TTP in read-only mode. 
  90.             "zap.ttp"       will open it normally. 
  91.                             (If the file may be written to in TOS.)
  92.  
  93.   The commandline dialog page also explains how the single-line editor
  94.   works.  This single-line editor is used also for the search-string
  95.   entry, so you may want to remember how it works. Not that there is
  96.   anything difficult to it, it's all very logical.
  97.   You can move the cursor, use backspace and delete, clear the line
  98.   with <Esc> and recall the original line with Undo.  Pressing Return
  99.   completes input, and if the line is empty ZAP exits. 
  100.  
  101.  *So, the way to quit ZAP is to press <Esc> <Return> at the command
  102.   line dialog.  If the file cannot be opened, or if the commandline
  103.   contains the wildcards '*' or '?' ZAP gives an error message and lets
  104.   you try again. 
  105.  
  106.  
  107.   *** The ZAP screen ***
  108.  
  109.   This consists of 4 parts: menubar, parameter section, file display, 
  110.   and command/message line. 
  111.  
  112.   The top line is the menu bar. It displays the main command options you 
  113.   have at your disposal at that point. 
  114.   There are two menu bars, one for the EDIT mode and one for the ESC mode.
  115.   You can see which mode ZAP is in by looking at the lower left corner 
  116.   of the screen.
  117.  
  118.   In EDIT mode, the menu bar shows:
  119.  
  120.   - ZAP 2.5
  121.     The name and version number of the program.
  122.     Click this for some info about ZAP and for my address.
  123.   - help
  124.     Click this (or press <Help>) to get a summary of the workings of 
  125.     ZAP in edit mode.
  126.   - Esc
  127.     Click this (or press <Esc>) to switch to ESC mode.
  128.   - addr
  129.     Click this to jump to an address in the file. This must then be 
  130.     entered in hexadecimal numbers. The first byte in the file has 
  131.     address 0, the last byte has address (filesize-1).
  132.   - undo
  133.     Click this (or press <Undo>) to read the displayed chunk from the 
  134.     disk into memory again. The situation is now as it was after this 
  135.     chunk was last saved. This will not affect changes that have already 
  136.     been saved to disk.
  137.   - top
  138.     Click this (or press <Shift><Clr Home> ) to get the first chunk.
  139.   - ^^^ ( arrows up )
  140.     Click this (or press <Shift><up>) to get the previous chunk.
  141.   - vvv ( arrows down )
  142.     Click this (or press <Shift><down>) to get the next chunk.
  143.   - end
  144.     Click this (or press <Insert> ) to get the last chunk.
  145.   - raw|txt
  146.     Click this to toggle the text only filter - useful if you are 
  147.     scanning a file quickly, looking for text. If the r/w flag was on,
  148.     this will be set to r-o (for read-only) until you toggle the text 
  149.     filter off again.
  150.   - r/w|r-o
  151.     Click this to lock the file to prevent accidental changes during 
  152.     browsing, and click it again to unlock it. If the lock is toggled to 
  153.     unlock, the text filter is automatically switched off too.
  154.    *If you attempt to change a file while r-o is in effect, this menu entry
  155.     will flash briefly to remind you.
  156.   - quit
  157.     Click this to save the current chunk and exit to the file selection 
  158.     dialog page. 
  159.  
  160.  
  161.   In ESC mode, the menu bar shows:
  162.  
  163.   - ZAP 2.5, as above. Here also accessible by pressing Z.
  164.   - Help - some info about ESC mode
  165.   - UnEsc
  166.     Click this, (or press Esc, or press U) to go back to edit mode.
  167.   - Print
  168.     Click this, (or press P) to print the current chunk. If the text filter 
  169.     is on, this will be used, otherwise non-printable characters will be 
  170.     replaced by a hyphen ( '-' ). (Since it is very unlikely that your 
  171.     printer knows the Atari graphics characters...)
  172.   - Number
  173.     Click this, (or press N) and you will be asked for a number of the 
  174.     chunk to display next. This must be entered in decimal.
  175.   - Search
  176.     Click this (or press S) to enter a string to search for.  Depending
  177.     on the state of ZAP, you will be asked to enter this string in HEX or
  178.     as text.  You may use control characters in the text state.  In HEX
  179.     state, the string must be specified as an even number of hexadecimal
  180.     digits.  As a null byte is used to terminate the string you can't
  181.     search for anything following a null byte.  Search is case-sensitive
  182.     and starts at the current cursor position. 
  183.   - Find
  184.     Click this (or press F). The same as above, but the search will use
  185.     the previously entered string for that state.
  186.   - Chunksize
  187.     Click this, (or press C), to change the size of a chunk.  The default
  188.     value, 256, is also the maximum.
  189.   - Quit
  190.     Click this, (or press Q) to exit to the file selection screen. 
  191.  
  192.   Besides these commands you can use the cursor keys and the mouse to
  193.   position the cursor and to switch between states. Placing the cursor 
  194.   in the HEX field with the mouse wil